API Examples

This document provides practical examples of REST and SOAP API calls used in gov.gr services, designed to assist developers with implementation and testing.

EMEP – SOAP Call Based on Tax Identification Number (AFM)

Endpoint: https://test.gsis.gr/esbpilot/notificationCenterElementsService

SOAP Request Example:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:not="http://gsis.ggps.interoperability/notificationCenterElementsInterface">
  <soapenv:Header>
    <wsse:Security soapenv:mustUnderstand="1">
      <wsse:UsernameToken>
        <wsse:Username>USERNAME</wsse:Username>
        <wsse:Password>PASSWORD</wsse:Password>
      </wsse:UsernameToken>
    </wsse:Security>
  </soapenv:Header>
  <soapenv:Body>
    <not:getNncIdentityRequest>
      <auditRecord>
        <auditTransactionId>1</auditTransactionId>
        <auditTransactionDate>2025-05-28T10:00:00Z</auditTransactionDate>
        <auditProtocol>1234</auditProtocol>
        <auditUnit>ΦΟΡΕΑΣ</auditUnit>
        <auditUserId>user</auditUserId>
        <auditUserIp>0.0.0.0</auditUserIp>
      </auditRecord>
      <getNncIdentityInputRecord>
        <afm>123456789</afm>
      </getNncIdentityInputRecord>
    </not:getNncIdentityRequest>
  </soapenv:Body>
</soapenv:Envelope>

AADE – SOAP Call for Data Verification

Endpoint: https://test.gsis.gr/esbpilot/individualConfirmationService

SOAP Request Example:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ind="http://gsis.ggps.interoperability/IndividualConfirmationInterface">
  <soapenv:Header>
    <wsse:Security soapenv:mustUnderstand="1">
      <wsse:UsernameToken>
        <wsse:Username>USERNAME</wsse:Username>
        <wsse:Password>PASSWORD</wsse:Password>
      </wsse:UsernameToken>
    </wsse:Security>
  </soapenv:Header>
  <soapenv:Body>
    <ind:getAFMIdentificationExtRequest>
      <auditRecord>
        <auditTransactionId>1</auditTransactionId>
        <auditTransactionDate>2025-05-28T12:00:00Z</auditTransactionDate>
        <auditUnit>ΦΟΡΕΑΣ</auditUnit>
        <auditProtocol>5678</auditProtocol>
        <auditUserId>user</auditUserId>
        <auditUserIp>0.0.0.0</auditUserIp>
      </auditRecord>
      <getAFMIdentificationExtRecord>
        <afm>137248864</afm>
      </getAFMIdentificationExtRecord>
    </ind:getAFMIdentificationExtRequest>
  </soapenv:Body>
</soapenv:Envelope>

SOE – REST API with JSON

Endpoint: https://test.gsis.gr/esbpilot/pubAuthDocManagementRestService/padEmplList

JSON Payload Example:

{
  "auditRecord": {
    "auditTransactionId": "111",
    "auditTransactionDate": "2025-05-28T09:00:00Z",
    "auditUnit": "ΦΟΡΕΑΣ",
    "auditProtocol": "9999",
    "auditUserId": "user",
    "auditUserIp": "0.0.0.0"
  },
  "padEmplListInputRecord": {
    "page": 1,
    "size": 10000,
    "lang": "el",
    "source": {
      "employee": {}
    }
  }
}

OAuth2 / OpenID Connect – Authorization Flow

Step 1: Authorization Request (Redirect):

GET https://auth.services.gov.gr/oidc/authorization?
client_id=CLIENT_ID&
redirect_uri=https://yourapp.gov.gr/authorize&
response_type=code&
scope=openid%20email%20profile&
state=xyz123

Step 2: Token Request (POST):

POST https://auth.services.gov.gr/oidc/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&
code=AUTH_CODE&
redirect_uri=https://yourapp.gov.gr/authorize&
client_id=CLIENT_ID&
client_secret=CLIENT_SECRET

Python Snippet – SOAP Call & XML Parsing

import requests
import xmltodict

xml_payload = '''<soapenv:Envelope>...</soapenv:Envelope>'''
response = requests.post(url='https://test.gsis.gr/endpoint', data=xml_payload)
parsed = xmltodict.parse(response.text)
print(parsed)

---

We'd love your feedback

Was this helpful?

Yes

No